home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TB / (A)TBD.ADF / Nib / Nib.doc < prev    next >
Text File  |  1989-09-12  |  17KB  |  430 lines
  1.  
  2.             STELLAR SYSTEMS, INCORPORATED
  3.  
  4.                   presents
  5.  
  6.                   NIB V1.0
  7.  
  8.             ⌐ Copyright 1989 Shawn Liptak
  9.                 All Rights Reserved
  10.  
  11.  
  12.  
  13.  
  14.     This initial release of NIB (V1.0) may be freely distributed as
  15. long as:
  16.  
  17.     A. No charge is made for the program.
  18.     B. No more than $5.00 U.S. is charged for the disk.
  19.     C. No file is deleted or edited in any way.
  20.  
  21.     NIB is intended for archival purposes and to ease the burden of
  22. such copy protection schemes as "Master Disk", "Key Word", and "Code
  23. Wheel". Software authors have the right and a necessity to make a
  24. profit on their products. So, if you use it, then BUY it!
  25.  
  26.  
  27. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  28.  
  29.                 SPECIAL OFFER
  30.  
  31.     NIB (V2.0) will be released as a commercial product in May or June
  32. of 1989. It will retail for $38.00 U.S. and feature new parameters, a
  33. disk editor, and an error checker. If you become a "Registered Owner"
  34. you will be entitled to
  35.  
  36.     A. NIB V2.0, which will be shipped to you free of charge
  37.     B. The first upgrade to V2.0 will cost $6.00 versus $9.00
  38.  
  39. To become a "Registered Owner" make out a check or money order to
  40. Shawn Liptak for $16.00 U.S.. Print or type the information in 
  41. the file Form.txt and...
  42.  
  43. Send to:
  44.             STELLAR SYSTEMS, Inc.
  45.             Attn. Shawn Liptak
  46.             P.O. BOX 9047
  47.             Hampton, VA 23670-0047
  48.  
  49. Note:
  50.     A. All registrations must be postmarked by May 15, 1989.
  51.     B. Virginia residents add 4.5% (72 cents) state sales tax.
  52.     C. To become a "Registered Owner" you must provide a valid
  53.         shipping address in the continental United States.
  54.  
  55.  
  56. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  57.     STELLAR SYSTEMS, Inc. is dedicated to providing quality
  58. software for the AMIGA series of computers. If you have software
  59. that is under development or finished and you are looking for a
  60. method of marketing it, please contact us at the address below.
  61. We can also provide code for specific applications such as custom
  62. disk access or title screens.
  63.  
  64.             STELLAR SYSTEMS, Inc.
  65.             Attn. Software Development
  66.             P.O. BOX 9047
  67.             Hampton, VA 23670-0047
  68.  
  69.     If you have any questions, comments, or complaints about
  70. STELLAR SYSTEMS or NIB, please write us at...
  71.  
  72.             STELLAR SYSTEMS, Inc.
  73.             Attn. PR
  74.             P.O. BOX 9047
  75.             Hampton, VA 23670-0047
  76.  
  77.  
  78. Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  79.  
  80. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  81.  
  82.                 NIB
  83.  
  84.  
  85.     Nib was written to be an economical disk backup system. It uses a
  86. precision disk nibbler combined with flexible parameters and a unique
  87. track selection system. This allows it to make working copies of a
  88. variety of protected software. The parameter system allows the copier
  89. to deprotect many titles and also to backup some especially tough
  90. ones. Nib's speed should be as fast as, if not faster, than the
  91. competition's and it should operate on all Amigas with a variety
  92. hardware configurations. Nib requires V1.2 or later of the Amiga's
  93. operating system.
  94.  
  95.  
  96. Limitations:
  97.  
  98.     Due to time constraints in development, Nib V1.0 does not support
  99. single drive copying and it does not check to see if the destination
  100. disk is write enabled. This will be added in V2.0.
  101.     When copying some copy protected programs Nib may indicate an error
  102. on certain tracks. You can use the ERR gadget to copy these bad tracks.
  103. If an error is still indicated then you should test the copy to see if
  104. it is ok.
  105.  
  106.  
  107. Multitasking:
  108.  
  109.     Nib will multitask with most programs without problems
  110. although there are a few things to keep in mind.
  111.  
  112.  1. If your source and destination drives are the same then
  113. Nib will attempt to read as much of the source disk as it can fit
  114. into available memory. So, it is best to have as much memory free as
  115. possible since a whole disk in nibble mode will require 2 Megs.
  116. * Note: This does not apply for V1.0, see Limitations:.
  117.  
  118.  2. When Nib is running it takes control of all floppy drives
  119. which makes it kinda difficult for the system or other programs
  120. to access the drives.
  121.  
  122.  3. When Nib is copying disks it tends to be a processor hog and
  123. will turn off multitasking for long periods of time. This will
  124. cause other programs to run slowly or not at all.
  125.  
  126.  4. When copying in either nibble mode, Nib will turn off the copper
  127. while it is reading or writing disk data. This causes the display
  128. to jump about and get very garbled looking (you'll see).
  129.  
  130.  
  131.     In light of the above I would suggest that you make a boot disk
  132. named SS.Nib that contains only Nib and it's associated files. Then
  133. to use Nib you would boot off of the SS.Nib disk which will start
  134. nib running with full memory use. The script file named "Execute.Me"
  135. will assist you in this operation.
  136.     You can also put Nib on a floppy or hard disk in a directory named
  137. for instance "NibMegaGreatCopier". This directory would contain the
  138. file "NIB" and a subdirectory named "NibData". The subdirectory would
  139. contain all of the other Nib files.
  140.  
  141. Then to start Nib from a floppy in DF1: type
  142.     Assign SS.Nib: DF1:NibMegaGreatCopier
  143.     SS.Nib:NIB
  144. or to start Nib from a hard disk partition named HD2: type
  145.     Assign SS.Nib: HD2:NibMegaGreatCopier
  146.     SS.Nib:NIB
  147.  
  148.  
  149.     Your questions and comments are welcome. If there are features
  150. or parameters you would like to see added to Nib or problems copying
  151. a disk please use the address given in the special offer section or
  152. leave me email on GEnie or "The Board".
  153.  
  154. GEnie S.Liptak1
  155. The Board  (804) 865-8773  300/1200  F8N1  On an Amiga 1000, 65 Meg
  156. online.
  157.  
  158.                         Enjoy,
  159.                         Shawn Liptak
  160.  
  161.                         March 1989
  162.  
  163.  
  164.                 Main Controls
  165.  
  166.     These are used to select the source and destination disks,
  167. verification, parameter and to start the copier. These gadgets are
  168. located in the left section of the screen and run from the top to the
  169. bottom of the screen. To use, select the appropriate gadget by
  170. positioning the mouse pointer over the gadget and depressing the left
  171. mouse button.
  172.  
  173.     Here are the steps to copy a disk:
  174.  
  175.     1. Select source drive.
  176.     2. Select destination drive(s).
  177.     3. Turn verify on or off.
  178.     4. Select a parameter.
  179.     5. Click "START COPY".
  180.     6. Insert appropriate disks.
  181.     7. Click on "OK!".
  182.     8. Sit back and watch it go (wheee).
  183.  
  184.     The rest of this section will deal with the various gadgets
  185. and what all this junk means.
  186.  
  187.  
  188. SOURCE:
  189.         Selects the disk drive that contains the disk you wish
  190.     to copy. Only one source disk may be selected.
  191.  
  192. DESTINATION:
  193.         Selects the disk drive(s) that contain the disk(s) you
  194.     will be copying to. You may select from 1 to 4 destination disks
  195.     provided that you have the drive connected to the Amiga.
  196.     Nib will not allow you to select a drive that you do not have.
  197.  
  198. VERIFICATION:
  199.         This toggles verification on or off. If turned on it
  200.     will cause the copier to read the information written to the
  201.     destination. This results in a slower copy, but it helps Nib
  202.     catch copy errors. I would suggest that you leave this on unless
  203.     you have a need to copy disks rapidly.
  204.  
  205. PARAMETER:
  206.         This brings up the parameter select requester.
  207.  
  208.         *****************************************
  209.         *       Select A Parameter      *
  210.         *                   *
  211.         *   Parameter1          *
  212.         *   Parameter2  UP      *
  213.         *   Parameter3     TOP/BOT  *
  214.         *   Parameter4  DN      *
  215.         *   Parameter5          *
  216.         *                   *
  217.         *    Finished           Forget It!  *
  218.         *****************************************
  219.  
  220.     UP: Scrolls the list of parameters towards the top of the list.
  221.     DN: Scrolls the list of parameters towards the bottom of the list.
  222.     TOP/BOT: Moves you to the top or bottom of the list. If you are
  223.         near the top you will go to the bottom. If you are near
  224.         the bottom you will go to the top.
  225.     Finished: Accepts the center parameter (Number 3) as the new
  226.         parameter and updates the current settings of the
  227.         track control.
  228.     Forget It!: Exits the menu with making any parameter changes.
  229.  
  230.         The top five parameters are used to select Nib's standard
  231.      copy modes. They are...
  232.     
  233.   NORMAL DOS COPY:      AmigaDos mode. Use for unprotected disks.
  234.   NORMAL NIBBLE COPY:       Nibble mode.
  235.   NORMAL NIBBLE+INDEX COPY: Nibble with index. (Best)
  236.   QUICK NIBBLE COPY:        Nibble except source track is read only
  237.                             once.
  238.   QUICK NIBBLE+INDEX COPY:  Same as "QUICK NIBBLE COPY" with index.
  239.  
  240.         "NORMAL NIBBLE+INDEX COPY" is the best mode for copying
  241.     nonstandard format tracks. The "QUICK" modes are faster but will
  242.     only produce accurate copies if the originals are indexed or
  243.     have only one sync mark per track.
  244.  
  245. START COPY:
  246.         This brings up the start copy requester.
  247.  
  248.         *****************************************
  249.         *                   *
  250.         *   Insert SOURCE disk in drive     *
  251.         *   DF0:    DF1:    DF2:    DF3:    *
  252.         *                   *
  253.         *    Insert DESTINATION disk in drive   *
  254.         *   DF0:    DF1:    DF2:    DF3:    *
  255.         *                   *
  256.         *   OK!             CANCEL! *
  257.         *****************************************
  258.  
  259.     DF0: thru DF3:  These will be indicated based upon the "SOURCE"
  260.             and "DESTINATION" selections.
  261.     OK!:        Starts the copy process.
  262.     CANCEL!:    Aborts the copy command.
  263.  
  264.         Before selecting "OK!" you should ensure that the write
  265.     protected source disk is in the correct drive and that the
  266.     write enabled destination disk(s) are in the indicated drives.
  267.     Nib does not check to see if the destination disks are write
  268.     enabled. It will still attempt the copy, which will result in
  269.     no data getting to the destination; if verify is on then you
  270.     will get LOTS of verify errors (0F/1F/2F).
  271.  
  272.         Once the copy starts you will get a window that looks
  273.     something like this...
  274.  
  275.     *************************************************
  276.     *   Track: 00               *
  277.     *   Destination: Max Words          *
  278.     *     FFFF    FFFF    FFFF    FFFF      *
  279.     *   Source: Index Time Delay        *
  280.     *     FFFF                  *
  281.     *   Source: Track Total Time        *
  282.     *     FFFF                  *
  283.     *   Source: Words Per Track         *
  284.     *     FFFF                  *
  285.     *   ERROR LOG: Track / Error #      *
  286.     *     00 0F  01 0F  05 2F  06 2F        *
  287.     *     1C 11  1E 22              *
  288.     *                       *
  289.     *                       *
  290.     *                       *
  291.     *   Press LEFT mouse button to abort    *
  292.     *************************************************
  293.  
  294.     Track: 00
  295.         Is the hex value of the current track (00 to A5).
  296.  
  297.         The next four items are used in the nibble modes and will
  298.     probably be useful only to the more advanced user.
  299.  
  300.     Destination: Max Words
  301.       DF0:  DF1:  DF2:  DF3:
  302.         The capacity of a track on the appropriate destination
  303.         drive. Typically 186A (Hex).
  304.  
  305.     Source: Index Time Delay
  306.       FFFF
  307.         The timer count from the index hole to the first sync
  308.         mark. Should be from 0 to less than track total time.
  309.         If many tracks have similar index times then it may have
  310.         an index type copy protection.
  311.  
  312.     Source: Track Total Time
  313.       FFFF
  314.         The time count for the disk to do one revolution.
  315.         Should be 6FDC for 300 RPM and an NTSC clock. Each count
  316.         equals 6.984 usecs. 8,590,908/count(decimal)=RPM.
  317.  
  318.     Source: Words Per Track
  319.       FFFF
  320.         The number of words of data on the current track.
  321.         186A is a normal value. If the value is substantially
  322.         larger (greater than 19E0) then it may have long track
  323.         type copy protection.
  324.  
  325.     ERROR LOG: Track / Error #
  326.         This section contains a log of the first 16 errors.
  327.         The first digit is the track number and the second
  328.         is the error code. The table below contains the error
  329.         codes and their meanings. Many errors can be cleared
  330.         by using the ERR gadget to copy the bad tracks again.
  331.  
  332.    x1=Could not locate a sync mark. If in any nibble mode, the read
  333.         routines will enter sync search mode. This can take up to
  334.         12 seconds and the screen will flash yellow during this
  335.         time.
  336.    x2=Can't find gap or too many sectors. Should not happen.
  337.    x3=No sync after gap. Will occur if source only has single sync
  338.        marks and mode is AmigaDOS.
  339.    04=Can't find sector (decode). You may have a bad source disk.
  340.    05=Can't find sector (encode). Same as above.
  341.    x8=Write error. Rare indeed.
  342.    xF=Verify failed. This is probably the most common error. If verify
  343.         is on then Nib will read the destination and compare with
  344.         the source. If different it will copy the track again and
  345.         do a second comparison. If the second comparison fails
  346.         then you will get this error. This may mean the destination
  347.         track is bad or is write protected. Verify will also
  348.         fail if the source track contains illegal MFM values or
  349.         has fluctuating bit type copy protection.
  350.     41=No sync on destination speed test. Should only occur if the
  351.         destination has a bad track or it's write protected.
  352.     
  353.     x equals the copy mode 0=AmigaDOS, 1=Nibble, 2=Index Nibble
  354.  
  355.  
  356.  
  357.                 Track Control
  358.  
  359.  
  360.     This unit determines which tracks will be copied and in what 
  361. mode it will occur. It also contains gadgets to access other functions
  362. when they are implemented (Error Checker, Disk Editor).
  363.  
  364.     The main unit is the track select and status indicator which
  365. appears like this...
  366.  
  367.             BOT        TOP                 +------+
  368.         --- -- ----- -0 - ----- -- ---             | MODE |
  369.         --- -- -----      ----- -- ---          +--+------+--+
  370.         --- -- -----      ----- -- ---      G.> |  AmigaDOS  |
  371.         --- -- -----      ----- -- ---          +------------+
  372.         --- -- -----      ----- -- ---      H.> |   Nibble   |
  373.         --- -- ----- -5 - ----- -- ---          +------------+
  374.         --- -- -----      ----- -- ---      I.> |Index Nibble|
  375.     +> [+]  --- -- -----      ----- -- ---  [+]     +------------+
  376.     |   --- -- -----      ----- -- ---                 +
  377.     |  [-]  --- -- -----      ----- -- ---  [-]        +-------+
  378.     |   |   --- -- ----- -10- ----- -- ---      J.>    |SET ALL|
  379.     |   |    |       |          |       |   [ERR]          +-------+
  380.     |   |    |       |          |       |     |
  381.     |   |    |       |          |       |     |
  382.     |   |   --- -- ----- -80- ----- -- ---    |
  383.     |   |   --- -- -----  |   ----- -- ---    |
  384.     |   |   --- -- -----  |   ----- -- ---    F.
  385.     |   |    |  |    |    |
  386.     |   |    |  |    |    The cylinder number
  387.     A.  B.   C. D.   E.
  388.  
  389.  
  390.     A. Plus: The plus gadget on the left selects all bottom tracks
  391.         The plus gadget on the right selects all top tracks.
  392.  
  393.     B. Minus: The minus gadget on the left deselects all bottom tracks
  394.         The minus gadget on the right deselects all top tracks.
  395.  
  396.     C. Track Status: Green indicates that the track was copied
  397.         successfully. Red means that there was a problem with
  398.         the track and you should see an error code in the error
  399.         log.
  400.  
  401.     D. Track Selection: This determines if the track is selected.
  402.         To change the state of selection you can either use the
  403.         plus, minus, or ERR gadgets, or you can use the mouse
  404.         pointer to toggle the indicator on or off.
  405.         Yellow = Selected for copy.
  406.         Black  = Not selected.
  407.  
  408.     E. Track Mode: The current copy mode of the track. This can be set
  409.         by selecting the appropriate mode (Items G, H, I.) and
  410.         clicking the mouse pointer on the track you wish to change.
  411.         White = AmigaDOS.
  412.         Green = Nibble.
  413.         Blue  = Index Nibble.
  414.  
  415.     F. Error Select: This gadget will deselect all good tracks (green).
  416.         This is handy when you make a copy and a few tracks show
  417.         error conditions (red). You can then select this gadget
  418.         and then "START COPY". This will cause only the bad tracks
  419.         to be recopied.
  420.  
  421.     G. AmigaDOS select:
  422.     H. Nibble select:
  423.     I. Index Nibble select:
  424.         Items G, H, and I set the current copy mode selection of
  425.     the mouse pointer for item E.
  426.  
  427.     J. SET ALL: This takes the currently selected gadget G, H, or I
  428.         and sets all of the tracks (item E.) to that mode.
  429.  
  430.